Skip to content

fix(uipath-planner, uipath-genome, uipath-platform): Decision Tree routing in authoring; Data sets, Captures, slug, complexity and Role defined; process check floors; login state from Data.Status - #4740

Open
danmunteanu1 wants to merge 6 commits into
mainfrom
fix/planner-flow-routing-data-sets-login-status

Conversation

@danmunteanu1

@danmunteanu1 danmunteanu1 commented Nov 15, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Fixes for rules that genome extraction and authoring runs read two ways, for checks that made runs pad a genome, and for a false fact runs wrote about the login.

  • Login state is Data.Status (uipath-platform § Step 1; uipath-genome preflight § 1.2 step 1). ExpirationDate is the current access token's, in UTC. uip renews an expired token from its refresh token, and reports Refresh Failed when that renewal fails and Expired when none ran (no refresh token, as with a client-credentials or environment-variable login). The build's preflight takes the session's state from Data.Status alone. Runs compared the UTC stamp with the local date, wrote a valid session as expired, skipped tenant reads and added a sign-in item to the build's setup.
  • author Step 5, documents and judgement. The capability table sent PDFs to Document Understanding activities in uipath-rpa and judgement to a uipath-agents component. The skill-mapping Decision Tree says otherwise: a document-extraction step of the component that uses it, and for one reasoning step among a Flow's steps, the Flow's inline agent. Both rows now point to Decision Tree items 3 and 5.
  • Step table Data sets: the sets that drive the step, meaning the rows or items it is run over. A set the recordset list marks drives: false (a configuration table, a file the step writes, a URL) goes to Notes. The guide said "the data sets the step's own objects read", and the strict check rejects configuration tables under that reading.
  • Step table Captures: screenshots, never a count of recorded UI actions.
  • Both definitions are changed in the builder's copy of the Source Map contract too, and extraction's Source Map step and the checker's message no longer restate the old reading.
  • Slug: underscores become hyphens, as spaces do (Order_Intake_Report → order-intake-report). "Strip other characters" ran the words together. Changed in both skills' copies.
  • Process genome checks. The strict check took a process genome's criteria floor from the component population matrix: 7 when any component is complex. Core also required two Handoffs rows. A process genome holds only end-to-end criteria, and a process with one library has one edge, so runs padded both. A process genome's floors are now the core floor of three criteria and one Handoffs row.
  • Complexity of an extracted component: the signal table's columns no longer overlap (entry points 1 / 2 / 3+, human waits 0 / none / 1+), a test component counts its test row in place of the workflow row, and the level is the middle of the counted rows, ordered simple to complex. "The level most counted rows land on; ties go lower" rated one component complex in one run and simple in the next.
  • Wrappers: an action with logic of its own around the activities now includes an object-model call no activity makes: an item's property, the application's own state the caller relies on once the action returns, or one of its commands. A setting the action sets and restores around its own work goes with its wrapper. The rule named only a property no activity sets.
  • Role line: producer and consumer, for a component that works the items it adds. The line listed no such value, and every run that met the shape wrote it anyway.
  • Keys of a configuration file the package ships: Configuration Questions item 4 made every key of a source's own configuration store a setting, because its owners change it without a release. A configuration file inside the project changes only with a release, so its keys are now facts unless they are bound to the environment. The RPA signals guide's REFramework rows already said so; two extractions of one solution followed one rule each and gave different question lists.

Verification

  • Login state: CLI source and live.
    • The @uipath/cli status resolver refreshes the token when its expiry has passed and a refresh token exists. It reports Refresh Failed when that refresh fails, and Expired when the expiry has passed and no refresh ran: no refresh token on file, or the environment-variable login.
    • Live: an expiry that had just passed moved forward on the next status call, still Logged in.
  • Runs on a tree with these changes:
    • Data sets were right from the first write, with no "drives nothing" failure.
    • Captures in a test suite's migration equal the export's screenshot steps, step by step.
    • None of 16 runs misread the login.
  • Runs before the check floors, the Role value and the complexity rule:
    • Two process genomes with one library each, a framework migration and a test suite's migration, padded their Handoffs tables and process criteria to pass the old floors.
    • Five runs wrote producer and consumer as a Role.
    • Two extractions of the framework migration rated its process component complex, then simple; a third, on the middle rule before the columns were made disjoint, medium.
  • A run with the floors: the framework migration passed the strict check on its first round, with its one real Handoffs row and four end-to-end criteria. The complexity rule is not rerun.
  • Checks:
    • Three new checker tests: a Handoffs table needs a row, one row is enough, a process genome's criteria floor is the core floor. Each fails on the checker before the change.
    • The planner _shared tests pass (240).
    • Links, flavors, skill status and validate-skill-descriptions on uipath-platform/SKILL.md (1022 chars) pass.
    • skills:test fails the same 20 tests as a base export of ef74031d2.

Changes

  • skills/uipath-platform/SKILL.md § Step 1
  • skills/uipath-genome/references/execution-guide.md § 1.2 step 1; genome-reading-guide.md § File Naming and Location and § Source Map, step table items 3 and 4
  • skills/uipath-planner/references/extract/extract-guide.md § Step 3 (wrappers), § Step 5 and § Step 6b; author/author-guide.md § Step 5; shared/extracted-genome-guide.md § Source Map, step table items 3 and 4; shared/genome-format-guide.md § File Naming and Location and § Configuration Questions item 4; shared/transactional-shape-guide.md Role line and the component template's
  • skills/uipath-planner/scripts/check-genome.mjs process floors and the Role placeholder; tests/tasks/uipath-planner/_shared/test_genome_check_findings.py

…uting in authoring, Data sets and Captures defined, underscores in slugs, the login state from Data.Status
@danmunteanu1
danmunteanu1 requested a review from a team as a code owner November 15, 2026 07:46
@github-actions

github-actions Bot commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Claude finished @danmunteanu1's task in 41s —— View job


Summary

Six one-line fixes in uipath-platform, uipath-genome and uipath-planner: login state now comes from Data.Status alone (not from ExpirationDate), the author Step 5 table defers to the skill-mapping Decision Tree, the step-table Data sets and Captures columns are tightened, and slugs turn underscores into hyphens.

Change-by-Change Review

1. skills/uipath-platform/SKILL.md:156 and skills/uipath-genome/references/execution-guide.md:31: login state

OK. Data.Status matches what the other skills already use (uipath-governance/references/auth-context.md:42, cli-cheatsheet.md:16). Saying that ExpirationDate is the access token's UTC expiry, and that the CLI renews it, removes the false "expired" reading the PR describes. Frontmatter is unchanged and no flavor override covers either passage.

2. skills/uipath-planner/references/author/author-guide.md:87,92: capability rows

OK. Both rows now match skill-mapping-guide.md items 3 and 5 (lines 50 and 52), and the link resolves. Low: the judgement row still lists "free-text decisions" while also offering "an LLM activity". Item 5 limits LLM activities to fixed generation with no decision. The pointer to item 5 settles which one applies, so this is wording only.

3. skills/uipath-planner/references/shared/extracted-genome-guide.md:17-18: Data sets / Captures

OK. drives: false matches the validator: scripts/check-genome.mjs:37,610 rejects such an entry with "drives nothing … name it in Notes". The Captures wording ("screenshots … never a count of recorded UI actions") agrees with the integer check at check-genome.mjs:492. Low: "the framework's recordset list" could name the file it means, the --recordsets JSON from the migration pack's data command (extract-guide.md:187), so the agent knows which file to read.

4. genome-format-guide.md:43 and uipath-genome/references/genome-reading-guide.md:23: slug underscores

OK. Both copies are changed the same way. Duplicating the rule in two skills is the right call, since skills must stay self-contained. Low: neither example list shows the new case. The PR body's Order_Intake_Report → order-intake-report would be a useful fourth example in both files, so that underscore handling has a worked example.

What's Missing

  • Nothing blocking.
  • Optional, out of scope: skills/uipath-api-workflow/references/cli-reference.md:529 shows the status shape as { "Status": ... } without the Data envelope. It could get the same Data.Status fix in a follow-up PR.

Area Ratings

Area Status Notes
Frontmatter OK Not touched
E2E Tests OK Wording fixes, no new capability
Skill Body OK uipath-platform Step 1
References & Assets OK Links resolve; wording matches check-genome.mjs
Repo Hygiene OK No secrets or paths; flavor overrides don't cover these passages

Issues for Manual Review

  • The CLI behaviour (refresh on expiry; Expired or Refresh Failed reported only when the refresh fails) is checked against @uipath/cli source and a live run in the PR body. I could not check it from this repo.

Conclusion

Approve. The changes are correct and agree with the Decision Tree and the genome checker. The three Low items are optional polish.

…et framework for migrations, producer-and-consumer role
…ws; the checker's Role placeholder matches the template
…ta sets and Captures copy, Step 6b and the checker message match; Expired means no renewal ran
… point to the Decision Tree; the wrapper rule names object-model calls
@danmunteanu1 danmunteanu1 changed the title fix(uipath-planner, uipath-genome, uipath-platform): Decision Tree routing in authoring, Data sets and Captures, slug underscores, login state from Data.Status fix(uipath-planner, uipath-genome, uipath-platform): Decision Tree routing in authoring; Data sets, Captures, slug, complexity and Role defined; process check floors; login state from Data.Status Nov 15, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant